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INTRODUCTION 

This supplement documents the actual structure and logic of the 
ProDOS system at nearly a byte by byte level. It is intended to 
aid experienced programmers in designing customized interfaces to 
ProDOS, and to provide implicit documentation of ProDOS' s 
functions. All assembly language programmers will find this 
supplement useful in learning about how an operating system works. 
This information is presented in the spirit of helping the user to 
better understand how ProDOS works. The authors do not endorse 
indiscriminant modification of the ProDOS components. Whenever 
possible, standardized interfaces to ProDOS should be used to avoid 
the uncontrolled modifications which plagued Apple's previous 
operating system, DOS 3.3. 

External system programs and utilities such as the FILER and 
CONVERT are not covered here, nor are disk controller ROM's covered 
other than the 5.25" controllers sold by Apple. 

The information presented here is for the release of the ProDOS 
operating system called Version 1.1.1. A previous supplement to 
Beneath Apple ProDOS documented the structure of Versions 1.0.1 and 
1.0.2 of ProDOS. 

UNDERSTANDING THE LISTINGS 

The listings which follow describe the major ProDOS components in 
great detail. Each module is presented separately and consists of 
a section defining external addresses referenced by the program 
(such as zero page usage, I/O select addresses, and global page 
fields) followed by a section describing the instructions and data 
in the module. Divisions between major sections and subroutines 
are indicated with a row of asterisks (*) and additional comments. 

Each detail line gives the address of the instruction or data field 
being described, followed by comments. Within the comments, the 
following notation is used to indicate references by instructions: 

(address) A store or load reference to a memory or I/O 

location. 
>>address A branch or jump to an address. 

<address> A call to a subroutine at the indicated address. 
— >address A pointer to an address. 

Page titles give the address of the next instruction or data area 
in the module to be described. These may be used to quickly locate 
a particular area within the component. 
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HOW "PRODOS" (Version 1.1.1) IS LOADED AND RELOCATED 

(3) Copy to HIRAM: 
^-^ IRQ Handler 



:rq 

System Global Page 

MLI Kernel 

Disk II Device Driver 



r. 



(T) The ProDOS Loader 
(or a "-" command) 
loads the "PRODOS" file 
to memory address $2000/ 
and jumps to it. 



"PRODOS" 
30 BLOCK FILE 



(29 data blocks 
plus one index 
block) 

L$3A00 



: — > 



\2) Copy from within Re- 
^^ locator to low memory; 

SYSTEM file Loader 

PAGE 3 IMAGE 

80-COL CARD CHECKER 



© 



Final moves; 
FUNCTTON 

Clock code 
QUIT code 
RAM drive. . , 

Caller 

Driver 



FROM TO 



4F00 D742 
5700 D100* 



2C00 FF00 
2A00 200** 



LENGTH 
7D 
300 

9A 
200 




SYSTEM GLOBAL PAGEI 

•I! 
I 
MLI I 

I- 

(load location) I 

I 

I$2D00 

I 
RELOCATOR l' 
I 

1 $2000 

I 



I 
I$96C 

SYSTEM file Loader I 
1 $8 00 

I 
I$400 

PAGE 3 IMAGE I 

I$3D6 

I 

1 $08 

80-COL CARD CHECKERI 
1$8 

1$0 
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HOW "BASIC. SYSTEM" IS LOADED AND RELOCATED 



(2) The BI Relocator moves 
the Interpreter to 
$9A00-$BCFF, and the 
BI Global Page to 
$BE00-$BEFF. 



© 



The "BASIC. SYSTEM" file 
is loaded to memory address 
$2000 by the SYSTEM file 
loader (or a "-" command) 
which then jumps to $2000 
(the BI Relocator) . 



"BASIC. SYSTEM" 
21 BLOCK FILE 



(20 data blocks 
plus one index 
block) 

L$2800 



: — > 



I 

I 

I BI GLOBAL PAGE 

I 

INAMES OF OPEN FILES 

I 

I 

I BASIC 

I 

I INTERPRETER 

I 

I (run location) 

I 

I 

I 

I 

I 

I BI GLOBAL PAGE 

I 

I 

I BASIC 

I 

I INTERPRETER 

I 

I (load location) 

I 



BI RELOCATOR 



$BF00 
$BE00 
$BD00 



$9A00 



$4800 
$4700 



$2400 
$2000 



© 



The BI Relocator searches for a 
"STARTUP" file in the same directory 
as "BASIC. SYSTEM". If found, it loads 
and executes the "STARTUP" program. 
Otherwise, it prints out a greeting 
and cold starts BASIC by jumping to the 
BASIC entry point at $BE00. 
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ERRATA TO BENEATH APPLE PRODOS (1st Printing, 1984) 

you can identify which printing of Beneath Apple ProDOS you have by 
looking at the space between the title of the book and the author s 
names on the first page of the book (the title page). If this 
space is blank, you have the first printing. The second printing 
has "Second Printing, March 1985" in this space. If you have the 
second printing, skip to page 120. If you have the first printing, 
all of the following errata apply. 

Page 3-16: 

in the first paragraph starting on the page, the sentence 
should read "The data is dealt with in larger pieces (512 
bytes vs. 256 bytes)...", not 512K vs. 256K. 



Page 6-63: 

The code for "HOW MUCH MEMORY IS IN THIS MACHINE?" is 
Replace it with: 

GET MACHID FROM GLOBAL PAGE 
MOVE BITS TO TEST POSITION 

48K 

128K 
OTHERWISE 64K 



The code for "GIVEN A PAGE NUMBER, SEE IF IT IS FREE" is 
incorrect. Replace it with: 

SEE PAGE 8-6 

GET PAGE NUMBER (MSB OF ADDR) 

LOCATE ITS BIT IN BITMAP 

IS IT ALLOCATED? 

YES, CAN'T TOUCH IT 

PUT BIT PATTERN IN ACCUM 

MARK THIS PAGE AS IN USE 

UPDATE MAP 

WE'VE GOT IT NOW 



incorrect. 


Repla 


LDA 


$BF98 


ASL 


A 


ASL 


A 


BPL 


SMLMEM 


ASL 


A 


BVS 

• • • 


MEM128 


page 6-64: 





BITMAP 


EQU 


$BF58 




LDA 


#PAGE 




JSR 


LOCATE 




AND 


BITMAP, Y 




BNE 


INUSE 




TXA 






ORA 


BITMAP, Y 




STA 


BITMAP, Y 
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LOCATE 



PHA 
AND 
TAY 
LDX 
PLA 
LSR 
LSR 
LSR 
TAY 
TXA 
RTS 



BITMASK DFB 
DFB 



#07 
BITMASK, Y 

A 
A 
A 



SAVE PAGE NUMBER 

ISOLATE BIT POSITION 

THIS IS INDEX INTO MASK TABLE 

PUT PROPER BIT PATTERN IN X 

RESTORE PAGE NUMBER 

DIVIDE PAGE BY 8 



Y-REG IS OFFSET INTO BITMAP 
PUT BIT PATTERN IN ACCUM 
DONE 



$80, $40, $20, $10 
$08, $04, $02, $01 



BIT MASK PATTERNS 



Page 7-9 



The code on page 7-9 is incorrect and should be replaced with 
the following: 



GET DEVCNT 

PICK UP LAST DEVICE NUM 

ISOLATE SLOT 

SLOT = 3? 

YES, CONTINUE 

CONTINUE SEARCH BACKWARDS 
CAN'T FIND IT IN DEVLST 
GET NEXT NUMBER 
AND MOVE THEM FORWARD 

REACHED LAST ENTRY? 

NO, LOOP 

REDUCE DEVCNT BY 1 

ZERO LAST ENTRY IN TABLE 



BRANCH ALWAYS TAKEN 
OLD VECTOR SAVEAREA 



* 


SQUISH OUT DE 




SKP 


1 




LDX 


$BF31 


DEVLP 


LDA 


$BF32,X 




AND 


#$70 




CMP 


#$30 




BEQ 


GOTSLT 




DEX 






BPL 


DEVLP 




BMI 


NO RAM 


GOTSLT 


LDA 


$BF32+1 




STA 


$BF32,X 




I NX 






CPX 


$BF31 




BNE 


GOTSLT 




DEC 


$BF31 




LDA 


#0 




STA 


$BF32,X 




CLC 






BCC 


OKXIT 




SKP 


1 


OLDVEC 


DW 
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HIMEM 

INSTALL 
INSLP 



ERROR 
INSLP2 



To reinstall the /RAM driver, execute this subroutine: 

SKP 1 

SEE IF SLOT 3 HAS A DRIVER ALREADY 



SKP 1 

EQU $73 

SKP 1 

LDX $BF31 

LDA $BF32,X 

AND #$70 

CMP #$30 

BEQ INSOUT 

DEX 

BPL INSLP 

SKP 1 

RESTORE THE DEVNUM TO THE LST 



PTR TO BI'S GENERAL PURPOSE BUFFER 

GET DEVCNT 
GET A DEVNUM 
ISOLATE SLOT 
SLOT 3? 
YES, SKIP IT 

KEEP UP THE SEARCH 



SKP 
LDX 
CPX 
BNE 



LDA 
STA 
DEX 
BNE 
LDA 
STA 
INC 
SKP 



1 

$BF31 
#$0D 
INSLP2 



GET DEVCNT AGAIN 
DEVICE TABLE FULL? 

YOUR ERROR ROUTINE 



$BF32-1,X MOVE ALL ENTRIES DOWN 
$BF32,X TO MAKE ROOM AT FRONT 
FOR A NEW ENTRY 

INSLP2 

#$B0 

$BF32 

$BF31 

1 



SLOT 3, DRIVE 2 AT TOP OF LIST 
UPDATE DEVCNT 



Page 7-26: 



Modifying the ProDOS Disk II Device Driver to allow 320 blocks 
instead of the normal 280. The fourth command line should 
read : 

520D:40 



Modifying FILER to format 40 tracks instead of 35. The fourth 
command line should read: 

4244 :40 
[See Second printing errata for information about versions other 
than 1.0.1] 
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Page 8-6: 

Under "Device Information", make the following changes: 
BF10-BF11 DEVADR01 Slot reserved. 

• • • 

BF26-BF27 DEVADR32 /RAM device driver address 

(need extra 64K) . 

Page 8-7: 

The wrong bit is indicated as the "expansion bit" in the 
MACHID byte. The first eight rows of that description should 
read : 



00.. 


0.. 


. II 


01.. 


0.. 


. 11 + 


10.. 


0.. 


Ile 


11.. 


0.. 


III emulation 


00.. 


1... 


Future expansion 


01.. 


1... 


Future expansion 


10.. 


1... 


lie 


11.. 


1... 


Future expansion 


Page B-8 : 







In the last paragraph, the sentence should read "A second way 
to use an interpreted language..." (not a compiled language). 



Page D-l! 



In the second paragraph, the sentence should read "Versions of 
the Disk Drive Controller Unit are now used..." (not based). 



Reference Card, Panel 4 

under "SYSTEM GLOBAL PAGE FORMAT", replace the lines beginning 
BF05 and BF06 with the following two lines: 

BF06 Jump to Date/Time Address 
(or RTS if no clock) 
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The description of BF10-11 should be changed to: 
BF10-11 Slot reserved 



The description of BF26-27 should be changed to: 
BF26-27 /RAM 

under the "MACHINE IDENTIFICATION BYTE", the second column of 
numbers should read: 



0.. 
0.. 
0.. 
0.. 
1.. 
1.. 
1.. 
1.. 



Reference Card, Panel 9 

The last entry for "MLI ERROR CODES" should be: 

$5A Bad vol. bit map 
(not $58) . 
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ERRATA TO BENEATH APPLE PRODOS (2nd Printing, 1985) 

Page 4-30 

The definitions of PARENT POINTER and PARENT ENTRY are 
incorrect. Replace them with: 

$27-$28 PARENT POINTER: The block number (within the volume 

directory or a subdirectory) which contains the file entry 
for this subdirectory. 

$29 PARENT ENTRY: The number of the file entry within the block 
number-pointed to by the PARENT_POINTER. Given that 
"ENTRIES_PER_BLOCK" is $0D, then the PARENT_ENTRY number 
ranges from $01 to $0D. 

Page 7-26 

Expand the 40-track drive patch to show how to patch PRODOS 
versions 1.0.2 and 1.1.1 as well as 1.0.1. 

This patch modifies the Disk II Driver, which is a part of the 
"PRODOS" file, so that it allows 320 blocks per volume instead of 
280 blocks per volume. 

UNLOCK PRODOS 

BLOAD PRODOS, TSYS,A$2000 

CALL -151 

address* :40 

3D0G 

BSAVE PRODOS, TSYS,A$2000 

LOCK PRODOS 
*"address" varies with the version of ProDOS, as follows: 

ProDOS Version address 

1.0.1 520D 

1.0.2 52CD 

1.1.1 56E3 
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The following patch modifies the program FILER to format 40 
tracks instead of 35. After this modification is made, only 40- 
track drives may be formatted with FILER. 

UNLOCK FILER 

BLOAD FILER, TSYS,A$2000 

CALL -151 

addr** :40 

79F4:28 

3D0G 

BSAVE FILER, TSYS,A$2000 

LOCK FILER 

**"addr" depends on the release date of FILER. Here are the values 
of "addr" for two different release dates: 

Release date addr 

1 JAN 84 4244 

18 JUN 84 426A 



ES 



Quality Software Products For the Apple 



BOOKS 

Beneath Apple ProDOS by Don Worth & Pieter Lechner 

Describes the ProDOS Operating System clearly and in detail, 

going beyond Apple's manuals. Many programming examples are 

included. 288 pages. 176 pages. $19.95 
Supplements to Beneath Apple ProDOS: 

Versions 1.0.1 and 1.0.2 (combined) $10.00 
Version 1.1.1 $12.50 

Beneath Apple DOS by Don Worth & Pieter Lechner 

The popular best seller that covers all facets of DOS 3.3 and 
previous Apple disk operating systems. 176 pages. $19.95 

Understanding the Apple II by Jim Sather 

Foreword by Steve Wozniak. A definitive source of information, 
covers Apple II and Apple II Plus hardware, including the disk 
controller and logic state sequencer. 352 pages. $22.95 

Understanding the Apple lie by Jim Sather 

The companion to Understanding the Apple II, this book covers 
Apple He hardware, including video graphics and the 1985 firmware 
upgrade (65C02) . 368 pages. $24.95 



UTILITIES 



Bag of Tricks 2 by Don Worth & Pieter Lechner 

Quality Software's popular set of Apple II disk utility 
programs. Bag of Tricks, has been thoroughly revised and updated 
for the ProDOS operating system. TRAX, INIT, ZAP, and FIXCAT are 
the four comprehensive utility programs, all with improved user 
interfaces to make them easier to use than the original Bag of 
Tricks.* Unprotected diskette and 200-page manual. 64K. $49.95 

♦Special offer to Bag of Tricks owners — save $20 by ordering 
directly from Quality Software. To order, send in your Bag of 
Tricks diskette and $29.95, plus shipping, handling, and sales 
tax. We will return your diskette along with the new product. 

Universal File Conversion by Gary Charpentier 

Moves programs and data among the five operating systems used 
on the Apple II family of computers: DOS, ProDOS, CP/M, Pascal, and 
SOS. Unprotected diskette and 48-page manual. 64K. $34.95 



Ordering directly from Quality Software 

To order our products directly, mail this order form to Quality 
Software (at the address below) with your payment — the price of the 
software (plus sales tax if shipped to California) plus shipping 
and handling charges. Your payment can be a check or bank draft 
made payable to Quality Software in US dollars, or your VISA or 
MASTERCARD number and expiration date (VISA and MASTERCARD holders 
may phone in their orders) . California residents must add the 
appropriate sales tax (6%, 6.5%, or 7%). 

Shipping charges: 

48 Continental United States (UPS) $2.50 

Alaska, Hawaii, Canada, and Mexico (air mail) $5.00 

All other countries (insured air mail) $10.00 

Send your order to: 

QUTiLrry softw7ir€ 

21610 Lassen Street #7 

Chatsworth CA 91311 

(818) 709-1721 

QUANTITY DESCRIPTION AMOUNT 



SUBTOTAL 

(CA RESIDENTS) SALES TAX 

SHIPPING 

TOTAL 

Check # 

OR VISA/MasterCard # EXPIRES 



Name 



Street Address 



City, State, Postal Code 
Country 



(1.1.1) 
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